'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\" $RCSfile: sge_shadowd.8,v $     Last Update: $Date: 2007-11-08 23:04:23 $     Revision: $Revision: 1.11 $
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB		\" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\" "
.de T		\" switch to typewriter font
.ft CW		\" probably want CW if you don't have TA font
..
.\"
.de TY		\" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M		\" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH xxQS_NAME_Sxx_SHADOWD 8 2007-11-08 "xxRELxx" "xxQS_NAMExx Administrative Commands"
.SH NAME
xxqs_name_sxx_shadowd \- xxQS_NAMExx shadow master daemon
.\"
.\"
.SH SYNOPSIS
.B xxqs_name_sxx_shadowd
.\"
.\"
.SH DESCRIPTION
.I xxqs_name_sxx_shadowd
is a "light weight" process which can be run on so-called shadow
master hosts in a xxQS_NAMExx cluster to detect failure of the current
xxQS_NAMExx master daemon,
.M xxqs_name_sxx_qmaster 8 ,
and to start-up a new
.M xxqs_name_sxx_qmaster 8
on the host on which the
.I xxqs_name_sxx_shadowd
runs. If multiple shadow daemons are active in a cluster, they
run a protocol which ensures that only one of them will start-up
a new master daemon.
.PP
The hosts suitable as shadow master hosts must have
shared root read/write access to the directory
.IR $xxQS_NAME_Sxx_ROOT/$xxQS_NAME_Sxx_CELL/common ,
as well as to the master daemon spool directory
(by default
.IR $xxQS_NAME_Sxx_ROOT/$xxQS_NAME_Sxx_CELL/spool/qmaster ).
The names of the shadow master hosts need to be contained in the file
.IR $xxQS_NAME_Sxx_ROOT/$xQS_NAME_Sxx_CELL/common/shadow_masters .
.\"
.\"
.SH RESTRICTIONS
.I xxqs_name_sxx_shadowd
may only be started by root.
.\"
.\"
.SH "ENVIRONMENT VARIABLES"
.\" 
.IP "\fBxxQS_NAME_Sxx_ROOT\fP" 1.5i
Specifies the location of the xxQS_NAMExx standard configuration
files.
.\"
.IP "\fBxxQS_NAME_Sxx_CELL\fP" 1.5i
If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx
cell
.I xxqs_name_sxx_shadowd
uses (in order of precedence):
.sp 1
.RS
.RS
The name of the cell specified in the environment 
variable xxQS_NAME_Sxx_CELL, if it is set.
.sp 1
The name of the default cell, i.e. \fBdefault\fP.
.sp 1
.RE
.RE
.\"
.IP "\fBxxQS_NAME_Sxx_DEBUG_LEVEL\fP" 1.5i
If set, specifies that debug information
should be written to stderr. In addition the level of
detail in which debug information is generated is defined.
.\"
.IP "\fBxxQS_NAME_Sxx_QMASTER_PORT\fP" 1.5i
If set, specifies the TCP port on which
.M xxqs_name_sxx_qmaster 8
is expected to listen for communication requests.
Most installations will use a services map entry for the
service "sge_qmaster" instead to define that port.
.\"
.IP "\fBxxQS_NAME_Sxx_DELAY_TIME\fP" 1.5i
This variable controls the time for which
.I xxqs_name_sxx_shadowd
pauses if a takeover bid fails. This value is used only when there are multiple
.I xxqs_name_sxx_shadowd
instances and they are contending to be the master.
The default is 600 seconds.
.\"
.IP "\fBxxQS_NAME_Sxx_CHECK_INTERVAL\fP" 1.5i
This variable controls the interval between
.I xxqs_name_sxx_shadowd
checks of the heartbeat file (60 seconds by default).
.\"
.IP "\fBxxQS_NAME_Sxx_GET_ACTIVE_INTERVAL\fP" 1.5i
This variable controls the interval between attempts by a
.I xxqs_name_sxx_shadowd
instance to take over when the heartbeat file has not changed.
The default is 240 seconds.
.\"
.\"
.SH "FILES"
.nf
.ta \w'<xxqs_name_sxx_root>/     'u
\fI<xxqs_name_sxx_root>/<cell>/common\fP
	Default configuration directory
\fI<xxqs_name_sxx_root>/<cell>/common/shadow_masters\fP
	Shadow master hostname file.
\fI<xxqs_name_sxx_root>/<cell>/spool/qmaster\fP
	Default master daemon spool directory
\fI<xxqs_name_sxx_root>/<cell>/spool/qmaster/heartbeat\fP
	The heartbeat file.
.fi
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M xxqs_name_sxx_conf 5 ,
.M xxqs_name_sxx_qmaster 8
\" .M xxqs_name_sxx_qmaster 8 ,
\" .I xxQS_NAMExx Installation and Administration Guide.
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.
